Standardvariablen

Systemvariablen - Mit dem Standardprotokoll können Tags erstellt werden, die auf HMI-Systemvariablen verweisen, bezüglich:

 

Einstellungen Protokolleditor

Wählen Sie in der SPS-Modellliste des Protokolleditors die Option Standard aus.

 

Einstellungen Tageditor

Pfad: Projektansicht> Konfig > Doppelklick auf Tags

  1. Um ein Tag hinzuzufügen, klicken Sie auf +: Es wird eine neue Zeile hinzugefügt.
  2. Wählen Sie in der Treiber-Liste Systemvariablen: Der Tag-Definitionsdialog wird geöffnet.

Element Beschreibung

Speichertyp

Es wird die Systemvariable dargestellt, auf die sich das Tag bezieht. 

Der folgende Abschnitt zeigt die vollständige Liste der möglichen Systemvariablen, nach Kategorien gruppiert.

Alarmvariablen
Variablenname Beschreibung Datentyp
Alarm not acknowledged

True, wenn nicht bestätigte Alarme vorliegen

(Nicht Ausgelöst Nicht Bestätigt<>0) ODER (Ausgelöst Nicht Bestätigt<>0)

boolean

schreibgeschützt

Alarm triggered

True, wenn mindestens ein Alarm ausgelöst ist

(Ausgelöst Bestätigt<>0) ODER (Ausgelöst<>0) ODER (Ausgelöst Nicht Bestätigt<>0)

boolean

schreibgeschützt

Number of missed alarm events Die Alarme, die die Ereigniswarteschlange übersteigen. Die Länge der Warteschlange wird in der Datei engineconfig.xml definiert.

int

schreibgeschützt

Number of not triggered acknowledged Der Alarmzustand ist nicht weiter aktiv. Die Alarme wurden bereits bestätigt

int

schreibgeschützt

Number of not triggered not acknowledged Der Alarmzustand ist nicht weiter aktiv. Die Alarme müssen noch bestätigt werden

int

schreibgeschützt

Number of triggered acknowledged Der Alarmzustand ist aktiv. Die Alarme wurden bereits bestätigt

int

schreibgeschützt

Number of triggered alarms Alarm aktiv: Bestätigung nicht erforderlich

int

schreibgeschützt

Number of triggered not acknowledged Alarmbedingung aktiv. Bestätigung erforderlich

int

schreibgeschützt

Summer-Variablen
Variablenname Beschreibung Datentyp
Buzzer Setup

0 = deaktiviert

1 = aktiviert (Summer ertönt hörbar bei jedem Touchscreen-Ereignis)

2 = Der Summerstatus wird von der Systemvariablen Summersteuerung oder von der Eigenschaft Summer bei Berührung in den "Projekteigenschaften" des Haupthandbuchs kontrolliert

 

Der Touchscreen-Buzzer (Setup=1) ist auf Linux-Plattformen nicht verfügbar. Siehe alternativ Eigenschaft "Summer bei Berührung".

int

Buzzer Control

0 = Summer aus

1 = Summer ein

2 = Summer blinkt

int

Buzzer Off Time Ausschaltzeitdauer in Millisekunden, wenn blinken ausgewählt wurde. Standard = 1000. Bereich: 100-5000

int

Buzzer On Time Einschaltzeitdauer in Millisekunden, wenn blinken ausgewählt wurde. Standard = 1000. Bereich: 100-5000

int

Kommunikationsvariablen
Variablenname Beschreibung Datentyp
Protocol Communication Status

Fasst den Status der Kommunikationsprotokolle zusammen.

0 = Es wird kein Protokoll ausgeführt, die Protokolltreiber wurde wahrscheinlich nicht korrekt auf das Bediengerät übertragen

1 = Protokolle wurden geladen und gestartet, kein Kommunikationsfehler

2 = Mindestens ein Kommunikationsprotokoll meldet einen Fehler

int

schreibgeschützt

Protocol Error Message

Kommunikationsfehler mit Fehlerquelle.

Zum Beispiel: "[xxxx]", wobei "xxxx" die Protokollabkürzung der Fehlerquelle ist.

Für den Fall von mehreren Fehlerquellen erscheinen mehrere Abkürzungen. Ein leeres Feld bedeutet, dass keine Fehler gemeldet wurden.

string

schreibgeschützt

Protocol Error Count Die seit dem letzten Zurücksetzen aufgetretene Anzahl an Kommunikationsfehlern. Das Zurücksetzen erfolgt mit der Aktion Protokoll-Fehlerzähler zurücksetzen, siehe "Systemaktionen" im Haupthandbuch

int

schreibgeschützt

Datenbankvariablen
Variablenname Beschreibung Datentyp
Database link error message

Zuletzt erkannte Fehlerbeschreibung

string

schreibgeschützt

Database link status

0 = Nicht definiert (noch nicht initialisiert)

1 = OnLine (bereit)

2 = OffLine (nicht verfügbar)

3 = Transfer in Ausführung

4 = Fehler

int

schreibgeschützt

Database link error count Fehlerzähler. Wird nach jedem Fehler erhöht

int

schreibgeschützt

Jede Datenbankvariable ist ein Array, wobei der Index die Datenbank-Anbindung auswählt (Bereich 1-10)
Die Variablen werden nur aktualisiert wenn eine Datenbank-Verbindungsaktion ausgeführt wird

Sommerzeit-Variablen
Variablenname Beschreibung Datentyp
Standard Offset Versatz in Minuten, wenn die Normalzeit in Bezug auf die GMT eingestellt wird (zum Beispiel: -8x60 = -480 Minuten)

int

schreibgeschützt

Standard Week Woche, in der die Normalzeit beginnt (zum Beispiel: First = 1)

int

schreibgeschützt

Standard Month Monat, in dem die Normalzeit beginnt. Bereich: 0-11. (zum Beispiel: November = 10)

int

schreibgeschützt

Standard Day Tag, an dem die Normalzeit beginnt (zum Beispiel: Sonntag = 0)

int

schreibgeschützt

Standard Hour Stunde, in der die Normalzeit beginnt (zum Beispiel: 02 = 2)

int

schreibgeschützt

Standard Minute Minute, in der die Normalzeit beginnt (zum Beispiel: 00 = 0)

int

schreibgeschützt

DST Offset Versatz in Minuten zur GMT, wenn die Sommerzeit eingestellt wird

int

schreibgeschützt

DST Week Woche, in der die Sommerzeit beginnt

int

schreibgeschützt

DST Month Monat, in dem die Sommerzeit beginnt. Bereich: 0-11

int

schreibgeschützt

DST Day Wochentag, an dem die Sommerzeit beginnt

int

schreibgeschützt

DST Hour Stunde, in der die Sommerzeit beginnt

int

schreibgeschützt

DST Minute Minute, in der die Sommerzeit beginnt

int

schreibgeschützt

Alle Variablen sind schreibgeschützt: Sie können nicht zum Aktualisieren der Systemuhr verwendet werden.

Gerätevariablen
Variablenname Beschreibung Datentyp
Available System Memory Frei verfügbarer RAM-Speicher in bytes

uint64

schreibgeschützt

Backlight Time Aktivierungszeit der Hintergrundbeleuchtung in Stunden seit der Herstellung des Gerätes

unsignedInt

schreibgeschützt

Battery LED

Aktiviert/deaktiviert die LED-Anzeige schwache Batterie (wenn vorhanden)

0 = deaktiviert

1 = aktiviert

Nicht verfügbar für Linux-Plattformen (die Plattform Ihres Gerätes finden Sie unter "HMI-Gerätefunktionen")

int

Display Brightness

Gibt die Helligkeit zurück und passt sie an.

Bei Einstellung einer niedrigen Stufe (0..3) bleibt die Hintergrundbeleuchtung für 8 Sekunden auf einer höheren Ebene, damit der Benutzer die Einstellungen vornehmen kann, und wird dann abgeschaltet.

Auch, wenn auf 0 gesetzt, ist die Hintergrundbeleuchtung weiterhin aktiv und der Zähler für die Hintergrundbeleuchtungszeit wird erhöht. Bereich: 0-255

int

External Timeout

Nicht operative Zeit, nach der die Hintergrundbeleuchtung wird automatisch ausgeschaltet wird. Die Hintergrundbeleuchtung wird automatisch eingeschaltet, wenn der Benutzer den Bildschirm berührt

-1 =

Abschalten der Hintergrundbeleuchtung und Berührung deaktivieren (Schalteranzeige aus). Der Zähler für die Hintergrundbeleuchtungszeit wird gestoppt.

BSP-Version 1.0.324 oder höher erforderlich.

-2 =

Die Hintergrundbeleuchtung ausschalten, aber die Berührung nicht deaktivieren. Wenn der Touchscreen berührt wird, wird das Ereignis nicht an Anwendungen weitergegeben, sondern der Bildschirmschoner geschlossen und die Hintergrundbeleuchtung eingeschaltet.

BSP-Version 1.0.324 oder höher erforderlich.

0 = Hintergrundbeleuchtung einschalten (Anzeige einschalten)
1..n =

Zeitablauf in Sekunden bis zum Abschalten der Hintergrundbeleuchtung (Timer für Bildschirmschoner)

Der Zeitablaufs-Wert wird auf das Vielfache von einer Minute (60, 120, 180, usw.) gerundet.

Die Plattform Ihres Gerätes finden Sie unter "HMI-Gerätefunktionen"

int

Flash Free Space Freier Speicherplatz im internen Flashspeicher

uint64

schreibgeschützt

Manufacturer Code Codenummer, die das HMI identifiziert

short

schreibgeschützt

Server RAM Usage Aktueller RAM-Speicher, der vom HMI verwendet wird, ausgedrückt in Byte

uint64

schreibgeschützt

System Font List Liste der Systemschriftarten

string

schreibgeschützt

System Mode

Runtime-Betriebsstatus

1 = Booten

2 = Konfigurationsmodus

3 = Betriebsmodus

4 = Neustart

5 = Herunterfahren

int

System UpTime Zeit, die das System seit der Herstellung des Gerätes eingeschaltet war (Stunden)

unsignedInt

schreibgeschützt

Informationsvariablen leeren
Variablenname Beschreibung Datentyp
Dump Error Message Rückgabe einer Fehlermeldung, wenn während des Sicherungsvorgangs Fehler auftreten

string

schreibgeschützt

Dump Archive Status

0 = Anfänglicher Standardzustand
1 = Vorgang ausgelöst
2 = Vorgang erfolgreich abgeschlossen
3 = Vorgang mit Fehler abgeschlossen

int

schreibgeschützt

Dump Recipe Status

0 = Anfänglicher Standardzustand
1 = Vorgang ausgelöst
2 = Vorgang erfolgreich abgeschlossen
3 = Vorgang mit Fehler abgeschlossen

int

schreibgeschützt

Dump Trend Status

0 = Anfänglicher Standardzustand
1 = Vorgang ausgelöst
2 = Vorgang erfolgreich abgeschlossen
3 = Vorgang mit Fehler abgeschlossen

int

schreibgeschützt

Reset Recipe Status

0 = Anfänglicher Standardzustand
1 = Vorgang ausgelöst
2 = Vorgang erfolgreich abgeschlossen
3 = Vorgang mit Fehler abgeschlossen

int

schreibgeschützt

Restore Recipe Status

0 = Anfänglicher Standardzustand
1 = Vorgang ausgelöst
2 = Vorgang erfolgreich abgeschlossen
3 = Vorgang mit Fehler abgeschlossen

int

schreibgeschützt

Netzwerkvariablen
Variablenname Beschreibung Datentyp
Gateway

Gatewayadresse der Haupt-Ethernet-Schnittstelle des HMI

string

schreibgeschützt

IP Address

IP Adresse der Haupt-Ethernet-Schnittstelle des HMI

string

schreibgeschützt

Mac ID MAC ID der Haupt-Ethernet-Schnittstelle des HMI

string

schreibgeschützt

Network Adapter Parameters JSON-String, die zum Lesen oder Aktualisieren der Parameter der Netzwerkadapter verwendet werden kann

string

Network Status

Enthält das Ergebnis des letzten Vorgangs, der für das Schreiben in den Kartenparametern erforderlich ist. Wird nach jedem Schreibvorgang aktualisiert.

  • Ein leerer String bedeutet, dass keine Fehler vorliegen
  • Beschreibungen der letzten Fehler

string

schreibgeschützt

Subnet Mask Subnetzmaske der Haupt-Ethernet-Schnittstelle des HMI

string

schreibgeschützt

SPS-Variablen
Variablenname Beschreibung Datentyp
Get CopyCodesysProject Action Status

Stellt den Status der Aktion CopyCodesysProject bereit.

0 = Aktion wurde nicht aufgerufen

1 = Aktion in Ausführung

2 = Aktion abgeschlossen

3 = Aktion abgebrochen (CHK-Datei fehlt)

4 = Aktion abgebrochen (PRJ-Datei fehlt)

5 = Aktion abgebrochen (SDB-Datei fehlt)

6 = Aktion abgebrochen (mehrere CHK-Dateien gefunden)

7 = Aktion abgebrochen (mehrere PRJ-Dateien gefunden)7 = Aktion abgebrochen (mehrere PRJ-Dateien gefunden)

8 = Aktion abgebrochen (mehrere SDB-Dateien gefunden)8 = Aktion abgebrochen (mehrere SDB-Dateien gefunden)

9 = Aktion abgebrochen (inkonsistente Dateinamen)

10 = Aktion abgebrochen (Verzeichnis kann nicht erstellt werden)

11 = Aktion abgebrochen (Kopieren fehlgeschlagen)

12 = Aktion abgebrochen (Codesys-Modul nicht vorhanden)

int

schreibgeschützt

PLC Status

Stellt den Status der internen SPS bereit.

0 = Ausführungsmodus

1 = Stopp-Modus

2 = von Datei neu laden

3 = Reset Warm

4 = Reset Kalt

5 = Reset Hart

int

SPS-Systemvariablen beziehen sich auf CODESYS V2 interne SPS

Bildschirmvariablen
Variablenname Beschreibung Datentyp
X Screen resolution Zeigt horizontale Bildschirmgröße in Pixel an

int

schreibgeschützt

Y Screen resolution

Zeigt vertikale Bildschirmgröße in Pixel an

int

schreibgeschützt

SD-Kartenvariablen
Variablenname Beschreibung Datentyp
SD Card FreeSpace

Verfügbarer Speicherplatz auf der Karte in bytes

uint64

schreibgeschützt

SD Card Name Name der SD-Karte

string

schreibgeschützt

SD Card Size Größe der in den Kartensteckplatz eingesteckten Karte in bytes

uint64

schreibgeschützt

SD Card Status

0 = SD-Karte nicht angeschlossen

1 = SD-Karte angeschlossen

int

schreibgeschützt

Servervariablen
Variablenname Beschreibung Datentyp
Page name Name der aktuellen Seite

string

schreibgeschützt

Project Name Name des aktuellen Projekts

string

schreibgeschützt

Project load time Datum, an dem das Projekt in die JMobile HMI Runtime geladen wurde, im Format Systemdatum (Millisekunden)

uint64

schreibgeschützt

Last operating mode start time

Zeitdauer in Sekunden, seitdem das Gerät den Betriebsmodus gestartet hat

uint64

schreibgeschützt

Alle Variablen beziehen sich auf Server, nicht auf den HMI Client.

Zeitvariablen
Variablenname Beschreibung Datentyp
Day Of Month Bereich: 1-31

int

Day of Week

Bereich: 0 = Sonntag, .. , 6 = Samstag

int

Hour Bereich: 0-23

int

Minute Bereich: 0-59

int

Month

Bereich: 1-12

int

Second

Bereich: 0-59

int

System Time Die Gleiche wie UTC-Zeit. Sie kann für diese Variable auch als Datum/Uhrzeit eingestellt werden unsignedInt
Year Aktuelles Jahr int

Die Systemzeit wird im UTC-Format angegeben

USB-Laufwerkvariablen
Variablenname Beschreibung Datentyp
USB Drive FreeSpace Verfügbarer Speicherplatz in Bytes

uint64

schreibgeschützt

USB Drive Name

Name des USB-Laufwerks

string

schreibgeschützt

USB Drive Size Größe des in den USB-Anschluss eingesteckten Geräts in Bytes

uint64

schreibgeschützt

USB Drive Status

0 = USB-Laufwerk nicht angeschlossen

1 = USB-Laufwerk angeschlossen

int

schreibgeschützt

Versionsvariablen
Variablenname Beschreibung Datentyp
Main OS version Version des Haupt-Betriebssystems

string

schreibgeschützt

Runtime version

Version der Runtime

string

schreibgeschützt

Project name Projektname

string

schreibgeschützt

Project version Projekt Version

string

 

Project GUID Projekt-GUID (eindeutige Kennung)

string

schreibgeschützt

Virtuelle Com-Switch-Variablen
Variablenname Beschreibung Datentyp
VCS status

Stellt den Status des VCS-Dienstes bereit.

0 = Dienst aktiviert

1 = Client im Interleaved-Modus verbunden

2 = Client im Exklusivmodus verbunden

3 = Dienst deaktiviert (Standard)

unsignedByte

schreibgeschützt

VCS disable

Bietet die manuelle Überschreibung des VCS-Dienstes.

0 = VCS-Dienst aktiviert

1 = VCS-Dienst deaktiviert (Standard)

boolean

VCS port Stellt den aktuell zuhörenden TCP-Port auf dem HMI durch den VCS-Dienst bereit unsignedShort

 

Datentyp

Jede Systemvariable hat einen spezifischen Datentyp, der in den obigen Tabellen beschrieben ist.

Die folgende Tabelle gibt die Details eines beliebigen Datentyps an, der für Systemvariablen verwendet wird.

Datentyp Speicherplatz Limits
short 16-Bit-Daten -32768 ... 32767
int 32-Bit-Daten -2.1e9 ... 2.1e9
unsignedByte 8-Bit-Daten 0 ... 255
unsignedShort 16-Bit-Daten 0 ... 65535
unsignedInt 32-Bit-Daten 0 ... 4.2e9
uint64 64-Bit-Daten 0 ... 1.8e19
string Array von Elementen, die eine Zeichencodierung enthalten, die durch die ausgewählte Codierung definiert wird

Arraygröße

Bei einem String-Tag repräsentiert diese Eigenschaft die maximale Anzahl an Bytes, die im String-Tag verfügbar sind.

Hinweis: Die Byte-Anzahl entspricht der Anzahl an String-Zeichen, wenn die Codierungseigenschaft im Tageditor auf UTF-8 oder Latin1 eingestellt wurde.
Wenn die Codierungseigenschaft auf UCS-2BE, UCS-2LE, UTF-16BE oder UTF-16LE eingestellt wurde, benötigt ein Zeichen 2 Bytes.

Konvertierung

Auf das Tag anzuwendende Konvertierung.

Je nach dem gewählten Datentyp zeigt die Liste Erlaubt eine oder mehrere der unten aufgelisteten Konvertierungstypen an.

Wert Beschreibung
Inv bits

inv: Invertiert alle Bits des Tags.

Beispiel:
1001 → 0110 (im Binärformat)
9 → 6 (im Dezimalformat)

Negate

neg: Stellt den Negativwert des Tag-Werts ein.

Beispiel:
25.36 → -25.36

AB -> BA

swapnibbles: Tauscht Nibble in ein Byte.

Beispiel:
15D4 → 514D (im Hexadezimalformat)
5588 → 20813 (im Dezimalformat)

ABCD -> CDAB

swap2: Tauscht bytes in ein Wort.

Beispiel:
9ACC → CC9A (im Hexadezimalformat)
39628 → 52378 (im Dezimalformat)

ABCDEFGH -> GHEFCDAB

swap4: Tauscht Bytes in ein Doppelwort.

Beispiel:
32FCFF54 → 54FFFC32 (im Hexadezimalformat)
855441236 → 1426062386 (im Dezimalformat)

ABC...NOP -> OPM...DAB

swap8: Tauscht Bytes in ein langes Wort.

Beispiel:
142,366 → -893553517,588905 (im Dezimalformat)
0 10000000110 0001110010111011011001000101101000011100101011000001

1 10000011100 1010101000010100010110110110110010110110000100111101
(im Binärformat)

BCD

bcd: Trennen Sie das Byte in zwei Nibbles, lesen Sie diese als Dezimalwerte (von 0 bis 9).

Beispiel:
23 → 17 (im Dezimalformat)
0001 0111 = 23
0001 = 1 (erstes Nibble)
0111 = 7 (zweites Nibble)

Wählen Sie Konvertierung und klicken Sie auf +. Das gewählte Element wird der Liste Konfiguriert hinzugefügt.

Wenn mehrere Konvertierungen konfiguriert sind, werden sie entsprechend ihrer Reihenfolge angewendet (von oben nach unten in der Liste Konfiguriert).

Verwenden Sie die Pfeiltasten, um die Reihenfolge der konfigurierten Konvertierungen zu ändern.